package com.rolerealm.service;

import com.rolerealm.domain.vo.UserInteractionVO;

import java.util.List;

/**
 * 用户行为数据收集服务接口（预留给用户管理模块实现）
 * 
 * @author RoleRealm Team
 * @version 1.0.0
 */
public interface UserInteractionService {

    /**
     * 记录用户行为
     * 
     * @param userId 用户ID
     * @param characterId 角色ID
     * @param interactionType 交互类型
     * @param durationSeconds 交互时长
     */
    void recordUserInteraction(Long userId, Long characterId, String interactionType, Integer durationSeconds);

    /**
     * 获取用户行为数据
     * 
     * @param userId 用户ID
     * @param days 最近天数
     * @return 用户行为数据
     */
    List<UserInteractionVO> getUserInteractions(Long userId, Integer days);
}
